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© SECTION ONE 
INTRODUCTION TO THE 


SUPER EXPANDER CARTRIDGE 


1.1 Introduction 
The VIC 1211A SUPER EXPANDER CARTRIDGE 


is an interesting and versatile programming aid. 
It adds new colors, new sets of graphics and an 
enlarged music-writing potential to the 
operating system of your VIC 20 computer. It 
also contains an extra 3K of memory (RAM) to 
enable you to write and RUN larger programs, 
programmable function keys to speed program 
writing and extra commands to plot graphic 
shapes and paint colors on the screen. The extra 
commands added by SUPER EXPANDER will 
extend the programming power of your VIC. 

This manual is not designed to teach BASIC 
programming on the VIC. If you have only a 
limited knowledge of BASIC programming, 
please refer to one of the following: 

VIC 20 User Manual (supplied with your 

computer) 

An Introduction to BASIC Parts 1 and 2 by 


Andrew Colin (part of the VIC learning series). 


1.2 The SUPER EXPANDER 
Manual 


This manual is divided into six parts as outlined 
below: 
SECTION ONE — INTRODUCTION TO THE 
SUPER EXPANDER 
CARTRIDGE 
This section discusses the SUPER EXPANDER 
in broad terms as well as explaining how to load 
the cartridge. It shows the range of commands 
supplied by the cartridge, how these commands 
are entered and what error messages will be 
displayed in the event of an incorrectly entered 
command. The compatability of SUPER 
EXPANDER commands with VIC BASIC is 
defined. 
SECTION TWO — USING THE FUNCTION 
KEYS 


This section describes the commands that are 
automatically assigned to the four function keys 
on the VIC keyboard and how the programmer 
may assign his own commands to these keys if 
he wishes. 


SECTION THREE — PLOTTING GRAPHICS 
WITH SUPER EXPANDER 

This section explains how the screen is divided 
for the purpose of graphics plotting and how the 
values indicating the colors used to draw 
graphics shapes are recorded. The format of 
each command is stated, its purpose given its 
use is explained and an example given in the 
form of a program entry. The commands are 
listed in the order that they might be used to write 
a BASIC program on the VIC such as the one 
contained in Section Six of this manual. 
SECTION FOUR — MAKING MUSIC WITH 

SUPER EXPANDER 

This section describes the SUPER EXPANDER 
commands used to create music on the VIC. The 
format of each command is given, its purpose 
stated, its use explained and an example given 
in the form of a program entry. The commands 
are listed in the order that is required to create 
and play a SUPER EXPANDER musical phrase 
on the VIC. 
SECTION FIVE — COMMANDS TO READ 

VALUES 

SUPER EXPANDER enables you to read the 
values in the registers used by the cartridge and 
the values returned by devices such as light 
pens, paddles, and joy sticks. The commands to 
do this are explained in this section. 
SECTION SIX — SUMMARY 

This section describes a program that was 
written using the additional SUPER EXPANDER 
commands. A full program listing is also 
included. 


1.3 Loading the Cartridge 


Always ensure that the power supply is off 
before inserting or removing the SUPER | 
EXPANDER CARTRIDGE. The cartridge is 
inserted into the expansion port of your VIC with 
the label facing up. (See your VIC 20 User Guide.) 
Ifa VIC 1010 Memory Expansion Board is in use, 
this also must be turned off. The SUPER 
EXPANDER cartridge may be used in conjunction 
with an 8K or 16K RAM pack. It may not be used 


with a 3K RAM pack as this already forms part 
of the SUPER EXPANDER cartridge. 

To begin using SUPER EXPANDER, simply turn 
the power on whilst the cartridge is in place. 
Your VIC will display: 


* *& & & CBM BASIC V2 kk & & 
6519 BYTES FREE 
READY ~ 


All the SUPER EXPANDER commands, the 
new colors and the new graphics sets are now 
included in the operating system of your VIC. 
You may use these commands at any time like 
any other BASIC command. You may also write 
longer programs using the extra 3K of memory 
(RAM) that is part of the cartridge. 

The initialization of the cartridge automatic- 
ally assigns eight SUPER EXPANDER commands 
to the four function keys on the right of the VIC’s 
keyboard, e.g. DRAW, CIRCLE, PAINT. These 
commands are displayed on the screen when 
either the function key is pressed on its own, or 


the or key is held down 
and a function key is pressed. (See Section 2.2.) 
The programmer is also given the facility to 
assign his own values to these keys, i.e. different 
from those generated by the cartridge. (See 
Section 2.3.) 


1.4 SUPER EXPANDER 
Commands 


The following is a list of SUPER EXPANDER 
commands which are added to the operating 
system of your VIC when the cartridge is 
inserted: 

Commands used to create graphics: 
GRAPHIC, COLOR, REGION, POINT, DRAW, 
CIRCLE, PAINT, CHAR, SCNCLR 

Commands used to write music: 

CTRL (left arrow), SOUND, 
P.Q,V,S,O,1,R,C,D,E,F,G,A,B, # ,$ 

Read Functions: 

RGR, RCOLR,RDOT,RSND,RPOT,RPEN,RJOY 

Added to the list above is the command KEY 
which enables the programmer to assign his 
own values to the function keys. (See Section 2.3.) 


1.5 Entering Commands 


All SUPER EXPANDER commands to create 
graphics may be used both in direct mode or as 
part of a program with the exception of the 
commands REGION and DRAW. These cannot 
be entered directly, i.e. they must be part of a 
program. In direct mode, the command is 
entered on the screen without a line number and 
is executed when the RETURN key is pressed. 


Note that in direct mode characters typed 
following the commands GRAPHIC1, GRAPHIC2 
and GRAPHIC3 will not be displayed on the 
screen. Extreme care must therefore be taken to 
ensure that any characters you type after these 
commands are typed correctly. Failure to do so 
will cause any display that may already have 
been on the screen to disappear. The message 
“SYNTAX ERROR’ will then be displayed on the 
VIC’s normal screen. 

SUPER EXPANDER commands used to write 
music can be used in both direct and indirect 
modes. In direct mode, the command SOUND is 
typed in and then executed by pressing the 
RETURN key. The remaining music commands 
are executed in direct mode simply by pressing 
the key assigned to the particular command. 

All SUPER EXPANDER functions except KEY 
can be used in your program just as you would 
use any other BASIC function. 

The command KEY can be used in direct mode 
only. It is typed in and then executed by pressing 
the RETURN key. 


1.6 Conventions 

The format of each SUPER EXPANDER 
command in this manual is presented using the 
following notation: 

1. Items written in capital letters should be typed 
exactly as shown. There is no need to use the 
SHIFT key to obtain capitals. 

2. Those items written in lower case letters 
indicate a user-specified entry such as a pair 
of screen coordinates or an octave number. 

3. The round brackets in the format of each 
SUPER EXPANDER read function must be 
typed in where shown. 

4, Other symbols such as commas and quotation 
marks must be typed exactly as shown. 

5. The return key is indicated by [RETURN]. 

6. VIC does not recognise the word “COLOUR”. 

The parameters used in the Super Expander 
commands are listed below: 


Parameter Value 


n An integer number 

SC Screen color 

bo Border color 

cha Character color 

au Auxiliary color 

c Color 

cr Color Register 

XY Screen Coordinates 

rx Half the width of a circle or ellipse 
ry Half the height of a circle or ellipse 
as Starting point of an arc 

af Finishing point of an arc 

Vv Volume of sound 


1.7 Compatability with the 
Rules of VIC BASIC 


The SUPER EXPANDER commands follow the 
same rules as VIC BASIC with one exception 
which is the BASIC code THEN. If this code 
precedes a SUPER EXPANDER command, a 
colon must be inserted after the code, e.g. 
THEN:SCNCLR. In all other respects, the SUPER 
EXPANDER commands are used in the same 
way as VIC BASIC commands. 


1.8 Storing and Running 
SUPER EXPANDER 
Programs 

A program written using the SUPER 

EXPANDER will not run unless the SUPER 

EXPANDER cartridge is in place on your VIC. 

The program may be saved on or loaded from 

diskette or cassette in the normal way. 


1.9 Termination of SUPER 
EXPANDER Programs 
To halt a program using SUPER EXPANDER 


commands whilst the program is running, hold 
down the RUN/STOP key and press the RESTORE 
key. In this way, you will return to the VIC’s 
normal screen. 


1.10 Indication of Errors 

The message “SYNTAX ERROR" will be 
displayed if any SUPER EXPANDER command is 
incorrectly spelt. You must then type the correct 
spelling. This same error message will also be 
displayed if any parameter is omitted from a 
command, e.g. CIRCLE with no height specified. 


SECTION TWO 
USING THE FUNCTION KEYS 


2.1 Introduction 


The SUPER EXPANDER CARTRIDGE uses the 
four function keys on the VIC’s keyboard to 
enable fast, efficient program writing. There are 
only four function keys but these give access toa 
total of eight commands. 

If you press the keys normally, the functions 
assigned to function keys F1,F3,F5 and F7 will 
be displayed on the screen. Holding down either 


the SHIFT or Ce] key and pressing these 


same keys will display those functions assigned 


to function keys F2,F4,F6 and F8. 


2.2 Preassigned Functions 


If you type KEY and press RETURN, the VIC 
will display a list of eight functions which are 
automatically assigned to the function keys 
when the SUPER EXPANDER CARTRIDGE is 
initialized. These functions are listed below: 


KEY 1, “GRAPHIC” 

KEY 2, “COLOR” 

KEY 3, “DRAW” 

KEY 4, “SOUND” 

KEY 5, “CIRCLE” 

KEY 6, “POINT” 

KEY 7, “PAINT” 

KEY 8, “LIST’’ + CHR$(13) 


2.3 Changing Key Assignments 
FORMAT : KEY 
or : KEY n, “value’”’ 


PURPOSE: To assign a new command to a 
function key. 


KEY allows you to display the values assigned 
to the function keys or to assign your own value 
to any function key, i.e. different from that 
generated by the SUPER EXPANDER cartridge. 
If you type KEY and press RETURN, the VIC will 
display a list of eight functions which are auto- 
matically assigned to the function keys when the 
cartridge is initialized. 

The value of a function key can be changed in 
two woys. The first of these methods is used 


4 when the function keys have been displayed as 


above. To change an assignment, move the 
cursor to the first position following the left hand 
set of quotation marks of the KEY number you 
wish to change. Overwrite the existing command, 
delete any remaining characters assigned to 
that key and press RETURN. SUPER EXPANDER 
will enter the right hand set of quotation marks 
automatically and store the new assignment. 

SUPER EXPANDER also includes a more 
direct method of changing the value of a single 
key. Simply type KEY, the number of the key you 
wish to change, a comma, a set of quotation 
marks and the value you wish to assign to that 
key. When you press RETURN, the second set of 
quotation marks will be added and the new 
assignment will be recorded. 

One hundred and twenty-eight is the 
maximum number of characters that may be 
assigned to any one function key. You may 
assign this number of characters to any or all of 
the function keys. 


EXAMPLE _ : Toassign the BASIC code 
RESTORE to the F5 function key: 


COMMAND: KEY [RETURN] 


DISPLAY — : KEY 1, “GRAPHIC” 
KEY 2, “COLOR” 
KEY 3, “DRAW” 
KEY 4, “SOUND” 
KEY 5, “CIRCLE” 
KEY 6, POINT” 
KEY 7, “PAINT’’ 
KEY 8, “LIST” + CHR$(13) 

: Move the cursor to the first 
position following the left-hand 
set of quotation marks on the line 
displaying KEY 5. 

: RESTORE [RETURN] 

: The BASIC code RESTORE is now 
assigned to the F5 key and will be 
displayed on the screen each 
time the F5 key is pressed. 


ACTION 


TYPE 
RESULT 


2.4 Adding Carriage Returns 


To eliminate the need to press RETURN 
following a function key command, you may 
add a carriage return to the command in the 
following way: 

(a) Change the assignment (see Section 2.3) of 
the key where you wish to add a carriage 


return, type the end quote marks but do not 
press RETURN. 


(b) Type + CHR$ (13) and press RETURN. 


Now, when you press this key, you will auto- 
matically generate a RETURN following the 
command. 

EXAMPLE _ : Toassign the BASIC code RUN 
and a built-in carriage return to 
the F7 function key: 

COMMAND: KEY 7, ““RUN’’ + CHR$ (13) 
[RETURN] 

RESULT : You may now run a program 
simply by pressing the F7 key. 
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SECTION THREE 


PLOTTING GRAPHICS WITH 
SUPER EXPANDER 


3.1 Introduction 


In Section Three, the new commands supplied 
by the SUPER EXPANDER cartridge to create 
graphics are described. The commands enable 
you to plot points, draw shapes, enter text and 
paint on the screen in any one of fifteen colors 
without having to access locations in memory. 
These commands are entered just like any other 
BASIC command and may be used in direct and 
indirect mode. The way the VIC holds the colors 
you have selected in color registers is also 
explained. The commands are listed in the order 
in which they might be used to write a program 
such as the one in Section Six of this manual. 


3.2 Screen Coordinates 


For the purpose of plotting graphics the screen 
is divided into a 1824 by 1824 matrix. A matrix is 
simply a grid in which a particular location is 
addressed by referring to its coordinates. A 
coordinate is a number used to state the distance 
of a point ona grid from the origin or @ point. 
Two numbers are required, one indicating how 
far the point is away from the origin in a 
horizontal direction and the other indicating 
how far the point is from the origin in a vertical 
direction. The horizortal is called the x axis and 
the vertical is called the y axis. The first coordinate 
stated in all plotting commands is the x 
coordinate. In SUPER EXPANDER, this is the 
position of a point on the screen relative to the 
left edge of the screen. The second coordinate is 
the y coordinate. This indicates how far down 
from the top of the screen the point is located. 
The origin or zero point of the screen grid in 
SUPER EXPANDER is the upper left corner of the 
screen. The coordinates of any point on the 
screen are in the range @ to 1923. 


3.3 Color Registers 


When the VIC is turned on with the SUPER 
EXPANDER cartridge in place, four color 
registers are assigned. (A register is simply a 
special memory location used to hold a value.) 
A number in the range @ to 15 is stored in each 
register and is used to indicate a color. The 


colors and their associated values are listed 
below: 


Q Black 

1 White 

2 Red 

3 Cyan 

4 Purple 

5 Green 

6 Blue 

7 Yellow 

8 Orange 

9 Light Orange 
10 Pink 
11 Light Cyan 
12 Light Purple 
13 Light Green 
14 Light Blue 
15 Light Yellow 


Register @ holds the value of the color used as 
the screen background in a graphics display. 


Register 1 contains the value of the color used to 
form the border surrounding the graphics screen. 


Register 2 holds the value of the character color, 
i.e. the color for plotting points, drawing 
graphic shapes or displaying text on a graphics 
screen. 

Register 3 holds the value of the auxiliary color 
which also may be used to plot graphic shapes. 
This register may only be accessed in multi-color 
mode or mixed mode. (See Section 3.4.1.) 


Initial color values are placed in these registers 
by executing the command COLOR. (See 
Section 3.4.2.) When the system is turned on, the 
values in the registers are 1,3, 6, and @ 
respectively. 


3.4 Graphics Commands 


All examples for commands used to create 
graphics are given in the following sections in 
the form of program entries. You may build up 
the program and RUN it after each new line is 
input. If you do so, before inputting the next line 
you must hold down the RUN/STOP key and 
press the RESTORE key. 


3.4.1 GRAPHIC 
FORMAT : GRAPHIC n 


PURPOSE: To select a graphics set from the 
VIC’s operating system. 

The command GRAPHIC may be used in 
direct and indirect mode. There are four 
different GRAPHIC modes, each of which 
selects a set of graphics from the VIC’s 
operating system. 

GRAPHIC @ is the VIC’s normal mode. This 
command is used to return to a normal screen 
display from a graphics screen. It is most 
commonly used at the end of a program 
containing graphics. 


GRAPHIC 1 selects the multi-color graphics set 
from the VIC’s operating system. In this mode, 
the VIC scales down the graphics plotting so that 
each position on the screen occupies an area 16 
dots wide and 8 dots deep within the 19824 by 
19624 dot screen matrix. (See Section 3.2.) Points 
may be plotted on the screen using any one of 
the four color registers available. (See Section 
3.3.) All 15 SUPER EXPANDER colors may be 
used in this mode. 


GRAPHIC 2 activates the high-resolution color 
graphics set in the VIC’s operating system. In this 
mode, each position on the screen occupies an 
area 8 dots wide and 8 dots deep within the 
screen matrix. Thus this mode displays points on 
the screen in a resolution twice as fine as that of 
the GRAPHIC 1 command. However, in this 
mode the colors in which points may be drawn 
onthe screen are restricted to those contained in 
registers @ and 2, i.e. the screen or character 
colors. Only those colors numbered @ to 7 may 
be used in this mode. (See Section 3.3.) If you 
specify a color value greater than 7 in the 
COLOR command, SUPER EXPANDER will 
subtract 8 from that value and use the color 
corresponding to the calculated value instead. 
The character color may be changed using the 
command REGION if you wish to use more than 
one color to plot points on the screen. (See 


Section 3.4.4.) 


GRAPHIC 3 activates either the multi-color or 
high-resolution graphics set depending on the 
value contained in the character color register 
after the command COLOR has been executed. 
(See Section 3.4.2.) If the value of the color lies 
within the range @to 7, all plotting will take place 
in high-resolution mode. If the color number is 
larger than seven, all points will be drawn on the 
screen in multi-color mode. This command is 
usetul if you wish to use high-resolution and 
multi-color graphics on the same screen. 
EXAMPLE _ : Toselect the high-resolution 
color graphics set: 


PROGRAM 
ENTRY: 108 GRAPHIC 2 


RESULT : The high-resolution graphics set 
within the VIC operating system is 
activated. 


3.4.2 COLOR 
FORMAT : COLOR sc,bo,cha,au 


PURPOSE: To assign colors to each of the four 
color registers. 


COLOR is used to select colors for the screen, 
the border, the character and the auxiliary 
color. The screen color, along with setting the 
background color, may also be used to erase 
points from the screen that have been plotted in 
a different color. The auxiliary color is used 
mostly with the command PAINT. (See Section 
3.4.7.) The value of each color is stored in one of 
four color registers in VIC’s memory. Once the 
registers have been set up with the COLOR 
command, the number of the color register 
forms the first parameter of all SUPER 
EXPANDER commands used to plot graphics on 
the screen. (See Section 3.3.) 

When the system is turned on, the four color 
registers contain the values 1, 3, 6, and @ 
respectively. 

The color registers available for use in multi- 
color and high-resolution modes are outlined 
below: 


multi-color 


@ screen color 

1 border color 

2 character color 
3 auxiliary color 


high-resolution 


@ screen color 
1 not available 
2 character color 
3 not available 


As you can see from the list above, the only 
color registers available for use in high- 
resolution mode are those containing the screen 
and character colors. This limitation can be 
eased by changing the character color with the 
command REGION if you require a different 
character color on the screen. (See Section 3.4.4.) 


EXAMPLE _ : Toselect a white screen, a blue 
border, a black character color 
and a pink auxiliary color: 

PROGRAM 


ENTRY: 118 COLOR 1,6,0,10 
RESULT : When this program line is 


executed, a white screen 
surrounded by a blue border is 
displayed. All graphics plotted 
using the color register containing 
the character color will be in 
black. If the auxiliary color is 
used, the plotting will be in pink. 
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3.4.3 POINT 
FORMAT : POINT cr,x,y 
or: POINT cr,x,y,xlyl...... xn,yn 


PURPOSE: To plot a point or points on the 
screen in a specified color. 


In multi-color mode, a point may be plotted on 
the screen in any of the colors available in the 
four color registers. (See Section 3.3.) In high- 
resolution mode, points may be plotted only with 
those colors available in the screen or character 
color registers. (See Section 3.4.2.) The command 
may be used to plot one or a number of points on 
the screen. If only one set of screen coordinates 
is specified in the command, then only one point 
will be plotted. Alternatively, you may specify a 
number of sets of screen coordinates which will 
result in that number of points being plotted on 
the screen. You may, however, only plot in one 
color in a single command. 

EXAMPLE _ : To plot asingle point on the 
screen in the color black: 


PROGRAM 
ENTRY: 128 POINT2,900,900 


RESULT : When this line is executed, a 
single black point will be displayed 
in the bottom right-hand corner 
of the screen. 

EXAMPLE _ : To plot four points on the screen 
in the same color: 

PROGRAM 

ENTRY: 130 POINT2,900,100,900,300, 
1000,188,1000,300 

RESULT : When this line is executed, four 


black points will be plotted in the 
top right-hand corner of the VIC’s 
screen. 


3.4.4 REGION 
FORMAT : REGION c 
PURPOSE: To change the character color 


REGION changes the character color which 
you previously specified in the command 
COLOR, 1.e. it changes the value stored in color 
register two. (See Section 3.4.2.) Any one of the 
15 SUPER EXPANDER colors may be used as the 
parameter of this command in multi-color 
mode. In high-resolution mode only colors 
numbered @ to 7 may be used. This command is 
especially valuable if you are in high-resolution 
mode and wish to create displays other than in 
the screen or character colors. (See Section 


3.4.2.) 

EXAMPLE _ : To change the character color to 
red: 

PROGRAM 


ENTRY: 148 REGION 2 


RESULT : When this program line is 
executed, the color value for red 
is stored in register two. Follow- 
ing the command, all points 
drawn on the screen which use the 
character color will be drawn in 
red. This will continue until the 
character color is changed with 
another REGION command. 


3.4.5 DRAW 

FORMAT : DRAW cr,x,y TO x1,y1 

or : DRAW cr,x,y TO x1,y1 TO x2,y2.... 
or : DRAW cr, TO x,y 


PURPOSE: To plot a straight line between two 
points on the screen. 


DRAW will plot a straight line in the color 
indicated in the color register specified. (See 
Section 3.4.2.) The DRAW command may be 
used in three ways: 


1. You may DRAW one line between two points 
on the screen specifying only one set of 
coordinates. Then, if you wish, you may use 
the command again to DRAW another line 
between different points on the screen. 


2. You may DRAW many lines with one DRAW 
command by specifying many sets of 
coordinates separated by the code TO. The 
first set of coordinates indicates the starting 
point of the first line to be drawn on the 
screen. The termination point of each line 
becomes the starting point of the next line. 

3. You may also DRAW specifying only the 
termination point of a line. In this case, the 
starting point of the line will be the 
termination point of the last graphic shape, 
circle or point. 

NOTE: In the latter case, if no previous shape 

has been drawn on the screen, the starting point 

of the line will be screen location @,Q, i.e. the top 
left-hand corner of the screen. 


EXAMPLE 
PROGRAM 
ENTRY: 158 DRAW 2, 100, 198 TO 209, 
180 TO 200, 200 TO 109, 208 TO 
100,190 


: To draw a rectangle: 


RESULT : Asmall red rectangle will be 
drawn in the top left corner of the 
screen when this program line is 
executed. 

EXAMPLE _ : To draw a diagonal line to the 
centre of the screen: 

PROGRAM 


ENTRY: 168 DRAW 2 TO 512,512 


RESULT : A line will be drawn from the 
point where VIC finished drawing 
the rectangle to the middle of the 


screen. 


3.4.6 CIRCLE 
FORMAT : CIRCLE cr,x,y,rx,ry 


or : CIRCLE cr,x,y,rx,ry,as,at 
PURPOSE: To draw a circular shape on the 
screen. 


The coordinates defined in the command 
CIRCLE specify the screen location of the centre 
of a circle or circular shape. The next set of 
parameters give the width and height of that 
shape from its centre. This last set of coordinates 
enables you to draw flattened circles, i.e. ellipses. 
Because of the way points are plotted on the 
screen, in order to draw a precise circle, rx does 
not equal ry as you would expect. You must 
multiply the rx parameter by @.7 to allow for the 
fact that the screen is rectangular although the x 
and y axes each have the same number of 
divisions. 

To draw an arc of a circle you must add a 
further set of parameters to the command 
CIRCLE. The first parameter is the starting point 
of the arc on the circumference of the circle and 
the second parameter is the finishing point of the 
arc. The unit used in these parameters is a 
“gradian’’. There are 18@ gradians ina 
complete circle. The position of gradian @ is at 
the 3 o'clock position ona clock face. Gradians 
increment in a clock-wise direction around the 
circumference of the circle finishing at gradian 
109, again at the 3 o'clock position. 


EXAMPLE — : Todrawacircle: 


PROGRAM 
ENTRY: 165 CIRCLE2,512,512,70,100 


RESULT : When this program line is 
executed, a red circle will be 
drawn in the middle of the VIC’s 
screen. 

EXAMPLE _— : Todrawtwo arcs of a circle: 

PROGRAM 


ENTRY: 170 CIRCLE 2, 880, 300, 140, 180, 
60 


4Q, 
180 CIRCLE 2, 800, 300, 140, 19, 
90,10 
: When these lines are executed, a 
set of round brackets will be 
drawn in red on the VIC’s screen. 


RESULT 


3.4.7 PAINT 
FORMAT : PAINT cr,x,y 
PURPOSE: To fill an enclosed area with color. 


PAINT fills in a whole area with the color 
indicated in the color register defined. The area 
must be completely enclosed or painting will 
take place over the whole screen. The area to be 
painted is specified by the coordinates of ANY 
point within its boundaries. 

Each area may only be painted once. If you 
are using the GRAPHIC 3 instruction set (see 
Section 3.4.1), an area which is bounded by 
drawing in multi-color mode must be painted in 
the same mode, i.e. you cannot change modes 
between creating the shape and painting it. 


EXAMPLE ~ : Todrawared circle and paint it 
in yellow: 
PROGRAM 
ENTRY: 198 CIRCLE 2,300,800,70,100 
195 REGION 7 
200 PAINT 2, 300,800 
RESULT : When this section of the program 


is executed, a small circle will be 
drawn in red in the bottom left- 
hand corner of the screen and the 
area inside the circle will be 
painted in yellow. 


3.4.8 CHAR — TEXT DISPLAY 

FORMAT : CHAR row, column, “text” 

PURPOSE: To display normal text ona graphics 
screen. 

CHAR will display normal text on a graphics 
screen beginning at the row and column 
defined. This command can be used in the 
GRAPHIC 2 high-resolution mode and in the 
GRAPHIC 3 mixed mode when the value of the 
color contained in the character color register is 
less than 8. (See Section 3.4.1.) This command is 
not available in GRAPHIC 1 multi-color mode. 
EXAMPLE _ : Todisplay the word “ART” in 

black on the graphics screen: 


PROGRAM 
ENTRY: 218 REGION @ 
220 CHAR 5,14,”ART” 

: When this section of the program 
is executed, the word ‘‘ART” will 
appear in black between the 
previously displayed set of 
brackets. (See Figure 3-1.) 


RESULT 


Can 





Figure 3-1 Text Display 


3.4.9 SCNCLR 

FORMAT : SCNCLR 

PURPOSE: To clear a graphics screen. 

SCNCLR is used in graphics mode to clear the 

screen in the same way that the BASIC statement 

PRINT “[SHIFT/CLR/HOME]"” is used. This 

command can be used in both direct and 

indirect modes. 

EXAMPLE _ : Toclear the graphics screen in 
the program listed above: 

PROGRAM 

ENTRY: 240 SCNCLR 

RESULT : When this line is executed, the 
screen will be blank, i.e. a white 
screen with a blue border. 


3.5 Running the Example 

To RUN the above as a complete program, 
add a delay loop before the screen clear and an 
end to the program as follows: 
PROGRAM 

ENTRY: 230 FOR X = 1 TO 250@:NEXT X 
258 GRAPHIC @:END 
When you run this program you will see an 


example of some of the simple graphics 
capabilities of SUPER EXPANDER. 


° SECTION FOUR 


MAKING MUSIC WITH 
SUPER EXPANDER 


4.1 Introduction 


This section includes all the steps required to 
make music or noise on the VIC with SUPER 
EXPANDER. Both music and noise can be 
played in direct or indirect mode. You may play 
a series of notes at the same time, i.e. a musical 
chord, or play a string of single notes or sounds. 
Within a program, a music phrase using single 
notes is created by entering the SUPER 
EXPANDER music characters inside a BASIC 
PRINT statement and “‘printing’’ the music. 
Music can also be created in direct mode 
without the use of a PRINT statement simply by 
pressing the VIC’s keys after entering music 
mode. To create a chord, the command 
SOUND is used in either direct or indirect mode. 
SOUND is also used to generate noise. 


NOTE: The pitch of notes or noise may differ 
slightly between different VICs. 


4.2 Sound Registers 


When the VIC is turned on with the SUPER 
EXPANDER cartridge installed, five sound 
registers are assigned. A register is a special 
location in memory which holds a value. The 
values in the five sound registers are placed 
there after the execution of the command 
SOUND. (See Section 4.3.1.) 

The registers are numbered 1 to 5. Registers ] 
to 4 are linked to the four voices of the VIC whilst 
register 5 is concerned with the intensity of the 
sound. A value in the range 128 to 255 placed in 
one of the first four registers will cause a sound 
to be played in the associated voice. If the value 
is less than 128, no sound will be played through 
the voice. 

Registers 1 to 3 will generate musical notes. 
(For a complete list of music notes and their 
associated numeric values, see Appendix F of 
your VIC 20 Computer User Guide.) Each 
musical sound register, i.e. one, two and three, 
has three complete octaves in its range. You can 
think of the first three music registers as “voices” 
much like the parts in singing, i.e. bass, treble 
and alto. Each register is one octave higher than 


its predecessor, i.e. a note played in octave 3 of 
sound voice | has the same pitch as the identical 
note played in octave 2 of sound voice 2 and 
octave 1] of sound voice 3. 

Register 4 is used to create “white noise”’ for 
special sound effects. 

Register 5 contains the value of the volume- 
level of music and/or noise. This value can be 
between @ (off) to 15 (loudest). (Note that in 
single note music mode, i.e. with the command 
V, you are limited to a maximum value of 9.) 


4.3 Music Commands 


In this section, the format of each SUPER 
EXPANDER music command is shown, its 
purpose given, its use described and an 
example given. All commands can be entered in 
direct or indirect mode. The command SOUND, 
which can create a musical “chord”, is shown as 
a direct mode entry. An example of all other 
music commands is given in the form of a 
program entry. Each of these commands is 
entered on one program line. In this way, a 
music phrase is built step-by-step until the tune is 
complete and ready to play. The new entry on 
the line is indicated in bold type. 


4.3.1 SOUND — PLAYING CHORDS 
FORMAT : SOUND s1, s2, s3, $4, s5 
PURPOSE: To create multi-voice sound effects. 


The command SOUND enables music chords 
to be played on the VIC. The parameters s1 to s3 
define the values of musical notes each in the 
range 128 to 255 which are to be played in one 
of the three VIC musical voices. A value less than 
128 for any one of these parameters will play no 
sound from the associated voice. (See Appendix 
F of your VIC User Guide.) The parameter s4 
defines the value of a ‘white noise” used to 
create special sound effects. It can contain a 
noise value within the same range, i.e. 128 to 
255, and may be switched off in the same way as 
voices | to 3. The parameter s5 defines the value 
of volume level set ranging from @ (off) to 15 
(loudest). The SOUND command is cancelled 
by assigning the value @ to all the voices or by 
assigning the value @ to parameter s5. 
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12 EXAMPLE 


EXAMPLE 


PROGRAM 
ENTRY: 308 FOR X = 1 TO 58: SOUND 
225,225,225,0,9 
319 NEXT X 
320 FOR X = 1 TO 58: SOUND 
230,230.230,0,9 
338 NEXT X 
340 FOR X = 1 TO 58: SOUND 
235,235,235,0,9 
350 NEXT X 
368 SOUND 6,0,0,0,0 
: A three chord triplet will be 
played when this section of the 
program is executed. 


an 
— ENTERING 


MUSIC MODE 
FORMAT : CTRL left arrow 
PURPOSE: To enter the SUPER EXPANDER 


music mode. 


CTRL left arrow can be used in both direct and 
indirect modes to enable you to make SUPER 
EXPANDER music on the VIC. The command is 
executed by holding down the CTRL key and 
pressing the left-arrow key. You may use the 
command inside quotation marks to “print” a 
series of musical notes and play the tune that has 
been composed. 

When you enter this command inside a PRINT 
statement, a reverse-field F will be displayed. In 
direct mode, you may use this command outside 
quotation marks. No symbol will be displayed 
on the screen. You may then use the keys of the 
VIC to play single note music just like any 
keyboard instrument. To terminate the music 
mode, press the RETURN key. 

When the CTRL left-arrow command has 
been executed, the SUPER EXPANDER music 
package interprets only those characters that 
form the music character set. They are: 


: To play a series of linked chords: 


RESULT 


4.3.2 


P,QV,S,O,T,R,C,D,E,F,G,A,B, # ,$ 


All other VIC keyboard characters are ignored 
by the SUPER EXPANDER cartridge. 

Within your program, you may enter up to 72 
of these characters in any one PRINT statement 
between the CTRL left arrow symbol and the last 
set of quotation marks. By reducing this figure to 
71 and adding a semi-colon following the last 
set of quotation marks, the next string of musical 
notes will be played immediately following the 
previous string of notes. To stop a tune while itis 
playing, simply hold down the RUN/STOP key 
and press the RESTORE key. 


: To write music in program mode: 


PROGRAM 
ENTRY: 370 PRINT “” (CTRL/left- 
arrow)” 


: A reverse-field F will be 
displayed. Any key you type 
between this character and the 
last set of quotation marks, until 
RETURN is pressed, will be 
interpreted by the SUPER 
EXPANDER music package when 
the program is run. 

: To begin making music in direct 
mode: 

: Hold down the CTRL key and 
press the left arrow key. 


: No character will be displayed 
on the screen but all music 
character keys will be inter- 
preted by the SUPER EXPANDER 
music package. Any key pressed 
that represents a music note, e.g. 
C,D or E will result in that note 
being played. 

4.3.3 P— DISPLAYING MUSICAL 

CHARACTERS 


FORMAT : P 


PURPOSE : To display all music characters on 
the screen. 


The command P can be used in direct and 
indirect mode. It is used to display the characters 
that you have used to create a piece of music as 
that music is being played. This command is 
especially useful as a composing aid. It will help 
you to see where any wrong notes appear in 
your music composition. You may then correct 
these notes with the VIC’s normal editing 
facilities. The command Q is used to halt music 
character display. (See Section 4.3.4.) 
EXAMPLE _ : Todisplay music characters in 

program mode: 


RESULT 


EXAMPLE 
ACTION 


RESULT 


PROGRAM 
ENTRY: 370 PRINT’ (CTRL/left-arrow) P” 

RESULT : When this line is executed, all 
music characters following the P 
on the line will be displayed on 
the screen. 

4.3.4 Q— CANCELLING MUSICAL 

CHARACTER DISPLAY 


FORMAT : Q 
PURPOSE: To cancel the display of musical 
characters. 

The command Q can be used both in direct 
and indirect mode. The command will halt the 
display of characters during music mode. 
EXAMPLE _— : Toplay music characters in direct 

mode with no screen display: 


ACTION :Hold down the CTRL key and 
press the left-arrow key to enter 
the music mode. Type Pand press 


keys Cand D. 

: Two notes are played and the 
characters C and Dare displayed 
on the screen. 

: Type Q and press the C and D 
keys again. 

: The same two notes are played 
but no characters are displayed 
on the screen. 

4.3.5 V— SETTING VOLUME 

FORMAT: Vin 

PURPOSE: To set the music volume. 

The command V sets the volume which will be 
used to play single notes of SUPER EXPANDER 
music, i.e. it is not used in conjunction with the 
command SOUND. This volume value can 
range from @ (off) to 9 (loudest). 


RESULT 


ACTION 


RESULT 


EXAMPLE _ : Tosetavolume of 9 prior to music 
writing in program mode: 
PROGRAM 
ENTRY: 379 PRINT ‘’(CTRL/left-arrow) 
Pv9” 
RESULT : When the line is executed, all 


music between the command and 
the second set of quotation marks 
will be played with the volume set 
at the highest level. This level of 
volume will continue until the 
command is used again to set a 
quieter volume. 


4.3.6 §S— CHOOSING A MUSIC VOICE 
FORMAT : Sn 
PURPOSE: To select a music voice. 


The command S is used to select one of the 
four sound voices available in VIC music mode. 
The voice chosen determines the “‘pitch’’ of the 
note or how high the note will be played. Each 
voice has three octaves in its range. (See Section 
4.3.7.) An octave is a group of eight notes. The 
voices are numbered | to 4. Voices 1 to3 are 
used to compose music with SUPER EXPANDER. 
These voices are analogous with Bass, Treble 
and Alto singing voices respectively. Voice 4 is 
used for creating “white noise” sound effects. 


EXAMPLE _ : Toselect sound voice 2: 
PROGRAM 
ENTRY: 37@ PRINT “(CTRL/left-arrow) 
PV9S2"’ 
RESULT : All subsequent music will be 


played using the second sound 
voice until the command is 
changed. 


4.3.7 O— OCTAVE SELECTION 
FORMAT: On 
PURPOSE: To select a music octave. 


The command O (the letter O as in Oscar not 
the number Q) is used to select a group of eight 
notes from which you wish to play a note. Each 
musical sound register, i.e. one, two and three, 
has three complete octaves in its range. Each 
sound voice begins one octave higher than its 
predecessor, i.e. a note played in octave 3 of 
sound voice 1 has the same pitch as the identical 
note played in octave 2 of sound voice 2 and 
octave 1 of sound voice 3. When playing notes in 
different sound voices, always ensure that the 
octaves are chosen correctly, i.e. to sing in close 
harmony, parts or unison. 


EXAMPLE _ : Toselectoctave 3 in the preceding 
program line: 
PROGRAM 
ENTRY: 370 PRINT’ (CTRL/left-arrow) 
PV9S203” 
RESULT : When this line is executed, all 


notes between the 3 and the 
second set of quotation marks 
will be played in the third octave 
of the second sound voice. 
4.3.8 T— CHOOSING A TEMPO 
FORMAT : Tn 
PURPOSE: To select the duration of a note. 
The command T selects the duration or tempo 
a oe according to the values in the following 
chart: 


TEMPO BEATS/ DURATION 
No. MINUTE (* 1/60 sec) 
0 900 4 
1 600 6 
2 450 8 
3 300 12 
4 225 16 
5 15d 24 
6 112.5 32 
7 56.25 64 
8 28 128 
9 14 255 
EXAMPLE _ : Toselecta tempo of 112.5 beats/ 
minute in the preceding program 
line: 
PROGRAM 
ENTRY: 378 PRINT’’(CTRL/left-arrow) 
PV9S203T6" 
RESULT : The note(s) between T6 and the 


second set of quotation marks 
will be played for a duration of 
32/6@ths of a second. 
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4.3.9 C,D,E,F,G,A,B — MUSIC NOTES 
FORMAT : letter 


where letter is any one or combina- 
tion of the characters CDEFGAB. 


PURPOSE: To play a musical note(s). 


The keys C,D,E,F,G,A and B are used to play 
notes in either direct or indirect mode. In direct 
mode, the note is played as the key is pressed. In 
indirect mode, the notes are enclosed in 
quotation marks as part of a PRINT statement. 
There is no need to place separating characters 
between musical notation in either mode. The 
SUPER EXPANDER music package will ignore 
any non-music character. 

EXAMPLE _ : Toplayamelody inthe preceding 
program line: 
PROGRAM 
ENTRY: 378 PRINT’’(CTRL/left-arrow) 
PVIS2O3T6CDE” 


: When this line is executed, three 
notes will be played and the 
musical characters will be 
displayed on the screen. 


4.3.10 R— PLAYING RESTS 
FORMAT : R 
PURPOSE: To play a musical rest. 


R is used to create silent periods in a musical 
composition, The length of the period, or rest, is 
determined by the command T. (See Section 
4.3.8.) 


RESULT 


EXAMPLE _ : To insert rests in the preceding 
program line: 

PROGRAM 

ENTRY: 378 PRINT’ (CTRL/left-arrow) 
PV9S2O3T6CRDRE”’ 

RESULT : When this line is now executed, 
the notes will be separated by 
rest beats. 

4.3.11 4 — PLAYING SHARPS 

FORMAT : # 

PURPOSE: To indicate that the following note is 

sharp. 


The command # is used in music mode to 
instruct the SUPER EXPANDER music package to 
play the next note sharp. Only the note 
immediately following the # is affected. 


EXAMPLE ~ : Toplay the notes C and C # in 
direct mode: 

ACTION _ : Type PRINT’(CTRL/left-arrow) 
PV9S203T6CR # C’ [RETURN] 

RESULT : Two notes will be played, the 


second a semi-tone higher than 
the first. 


4.3.12 $— PLAYING FLATS 
FORMAT : $ 
PURPOSE: To play the next note flat. 


The command $ is used in the music mode to 
instruct the music package to play the following 
note flat. Only the note following the command 
will be affected. 


EXAMPLE _ : Toplay the notes B and B$ in 
direct mode: 

ACTION _— : Type PRINT’ (CTRL/left-arrow) 
PV9S203T6BR$B” [RETURN] 

RESULT : Two notes will be played, the 
second a semi-tone lower than 
the first. 

4.4 Summary 


Putting together all the music commands listed 
above, you can play a simple tune such as the 
one below: 


PROGRAM 
ENTRY: 37@ PRINT “(CTRL/left-arrow) 
PV9S2O3T6éCDET4CRT 
6CDET4CRT6EFT7GT 
4RT6EFT7G" 


"SECTION FIVE 
COMMANDS TO READ VALUES 


5.1 Introduction 


This section illustrates the seven read 
functions that are part of the SUPER EXPANDER 
command set. These functions can be used in 
direct and indirect mode. In direct mode, the 
function must be preceded by the BASIC code 
PRINT and the RETURN key pressed following 
the function to display the value read. The functions 
enable you to determine values created by 
certain SUPER EXPANDER commands or by 
games control devices. For example, using one 
of these functions, you can read the values of the 
color registers you set up with the command 
COLOR or the sound registers you set up with 
the command SOUND. If you incorporate the 
use of games paddles, the joystick or the light 
pen in your program, you can use a function to 
determine the value indicated by a games 
device at a moment in time. The format of each 
function is shown, its purpose given, its use 
explained and an example shown. 


NOTE: In the formats listed below, the brackets 
must be included in the command statement. 


5.2 RGR 
FORMAT : RGR (n) 


PURPOSE: To read the graphics mode that was 
set with the command GRAPHIC. 


This function reads the number of the graphics 
mode that was set with the command GRAPHIC. 
(See Section 3.4.1.) Any number in the range 9 to 
255 can be used as the parameter of this function. 
Whilst a parameter must be stated, its value 
does not affect the value returned by the 
function. This function is useful in program mode 
when you wish to change from one graphics 
mode to another and then return to the original 
graphics mode. This function is not valuable in 
direct mode because it always returns a value of @. 


EXAMPLE ~ : Todraw three circles, changing 
color and graphics mode before 
each: 

PROGRAM 

ENTRY: 18 GRAPHIC 2 


20 COLOR 1,6,0,10 


38 CIRCLE 2,512,512,70,100 


40 X = RGR (0) 

58 GRAPHIC 3 

60 REGION 10 

7@ CIRCLE 3,859,750,70,100 

88 GRAPHIC X 

90 REGION O 
108 CIRCLE 2,300,800,70,100 
110 FOR Z = 1 TO 1000: NEXT: 

GRAPHIC @ 

RESULT : When the above program is 
RUN, the number of the first 
graphics mode is assigned to the 
variable X and that variable is 
used to set up the third graphics 
mode. 

5.3 RCOLR 


FORMAT : RCOLR (cr) 
PURPOSE: To read the color contained ina 


color register. 


This function will read the value of the color 
contained in the color registers which you 
assigned by the command COLOR or changed 
with the command REGION. The function is 
especially useful in high-resolution mode when 
you wish to plot a point on the screen with a 
color other than the screen and character color 
and do not wish to use the command REGION. 


EXAMPLE ~ : Todrawacircle in high- 
resolution using the character 
color and paint it in the auxiliary 
color: 

PROGRAM 


ENTRY: 10 GRAPHIC 2 
20 COLOR 1,6,0,2 
30 CIRCLE 2,512,512,70,100 
49 Q = RCOLR (3) 
59 REGION Q 
69 PAINT 2, 512,512 


: When the above program is RUN, 
the color contained in color 
register 3 will be read and that 
color will be used to paint the circle. 


RESULT 
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5.4 RDOT 
FORMAT : RDOT (x,y) 


PURPOSE: To obtain the color value of a dot on 
the screen. 


The RDOT function will read the color value 
of a dot located at the position in the screen 
matrix given in the function parameters. (See 
Section 1.4.) This function is most useful in multi- 
color mode when you wish to plot points or draw 
graphics shapes on the screen with a paint color. 


EXAMPLE — : Todrawand paint a circle in 
multi-color mode and draw a 
second circle with the color used 
when painting: 

PROGRAM 

ENTRY: 18 GRAPHIC 1 
20 COLOR, 1,6,0,10 
30 CIRCLE 2,512,512,78,100 
40 PAINT 3,512,512 
50 X= RDOT(512,512) 
69 REGION X: CIRCLE 2,759, 
750,708,100 


RESULT : When this program is RUN, a 
black circle painted in pink anda 
pink circle will be displayed on 
the screen. 

5.5 RSND 


FORMAT : RSND (n) 

PURPOSE: To read the value of a sound register. 
The function RSND reads the value of a note in 

the first four sound registers set up by SUPER 

EXPANDER and the value of the volume set in 

the fifth sound register. (See Section 4.2.) This 

function can only be used to determine the 


contents of the sound registers following the 
command SOUND. (See Section 4.3.4.) 


EXAMPLE _— : Touse the RSND function within a 
program: 
ACTION _ : Type inthe following short 


program and RUN it: 
PROGRAM 
ENTRY: 19 X = 225 : SOUND X,X,X,0,9 
20 Y = RSND (5) 
30 FOR Z = YTO®@STEP —1 
48 SOUND X,X,X,0,Z 
58 FORC = 1TO 500: NEXT C,Z 
60 FORZ =@TOY 
70 SOUND X,X,X,8,Z 
88 FOR C = 1 TO 5@@ NEXT C,Z 
98 SOUND X,X,X,0,0 
: A musical chord will be played, 
first falling and then rising in 
volume. 


RESULT 


5.6 RPOT 
FORMAT : RPOT (n) 
PURPOSE: To read the value of a paddle. 

The function RPOT will read the value of a 
paddle and return a figure in the range @ to 255. 
This represents the position of the paddle 
relative to the left edge of the screen. The value 
of n is @ to read one paddle and 1 to read the 
other. 


EXAMPLE _ : To read the value of a paddle in 
direct mode: 

ACTION _ : Connectapaddle set to the game 
port on your VIC. (See your VIC 
20 User Guide and accompanying 
literature.) Turn the paddle 
control in a clockwise direction 
until you reach the furthest 
position. 

TYPE : PRINT RPOT (8) [RETURN] 

DISPLAY :@ 

ACTION — : Turn the paddle control as far as 
it can go in the opposite direction. 

TYPE : PRINT RPOT (@) [RETURN] 

DISPLAY —: 255 

5.7 RPEN 


FORMAT : RPEN (n) 
PURPOSE: To read the value of the light pen. 


The function RPEN will read the position on 
the screen at which the light pen is pointing. If 
n = M the position relative to the left edge of the 
screen will be read (the X value) and if n = 1 the 
position of the pen in relation to the top of the 
screen will be read (the Y value). A value in the 
range @ to 255 will be returned in both cases. 
NOTE: If the values returned by this function fall 
outside this range, your light pen will need to be 
calibrated. To do this, refer to the instructions 
supplied with your pen. 
EXAMPLE _ : To read the point on the screen at 

which the light pen is pointing: 


ACTION _ : Connecta light pen to the games 
port on your VIC. 
Type in the following program 
and RUN it: 

PROGRAM 

ENTRY: 19 X = RPEN(@):Y = RPEN(1): 
PRINT X,Y:GOTO 10 

ACTION _— : Pointthe light pen at different 
positions on the screen. 

RESULT : Aseries of pairs of numbers will 


scroll up the screen. The number 
on the left is the X value and the 
number on the right is the Y value. 


5.8 RJOY: 
FORMAT : RJOY (n) 
PURPOSE: To read the value of the joystick. 


The function RJOY determines the value which 
indicates a joystick movement. You may use any 
number between @ and 255 as the parameter of 
this function. Whilst a parameter must be stated, 
its value does not affect the value returned by the 
function. 

The values generated by the joystick when it is 
moved in each direction and when the fire- 
button is pressed is given on the chart below. A 
diagram showing these values is Figure 5-1. 


DIRECTION VALUE 
UP ] 
DOWN 2 
RIGHT 8 
LEFT 4 
RIGHT DIAGONAL UP 9 
LEFT DIAGONAL UP 5 
RIGHT DIAGONAL DOWN 10 
LEFT DIAGONAL DOWN 6 
FIRE BUTTON 128 
NO MOVEMENT Q 
FIRE BUTTON 


1 Cz COMMODORE 
9 





Figure 5-1. Joystick Values 


EXAMPLE _ : Toreturnall possible values of 
the joystick: 
ACTION _ : Insert the joystick into the games 


port on your VIC. (See your VIC 
User Guide.) 


Type in and then RUN the 
following short program: 
PROGRAM 
ENTRY: 18 X = RJOY (@) : PRINT X 
20 FOR S = 1 TO 1000 : NEXT 
38 GOTO 108 


ACTION — : Move the joystick around and 
press the fire-button whilst the 
program is running. 

RESULT : The values of all the joystick 


positions and of the fire-button 
are displayed on the screen. 


5.9 The Use of Read Functions 


The functions which read the values of games 
devices have an obvious use. When you write 
games, you will need to know the position that 
the player has indicated. RPOT, RJOY and RPEN 
enable you to do this with ease. 

The chief value of the other commands is as a 
debugging or diagnostic tool. If your program is 
not running correctly, you may, for example, 
read the values of the color or sound registers at 
a particular point and see if the values returned 
are what you expected. 


7 
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SECTION SIX 
SUMMARY 


6.1 Introduction 

This section contains a program that was 
written using the SUPER EXPANDER cartridge. 
The program is described and a full program 
listing is given in order that you may try the 
program out yourself. 


6.2 Program Description 


The first part of the program contained in 
Section 6.3 illustrates some of the many shapes 
that can be plotted on the screen using the 
SUPER EXPANDER high-resolution graphics set. 
The second part of the program incorporates 
music into the program while the corresponding 
notes are actually being drawn ona music stave 
on the screen. 


6.3 Program Listing 
The following is a complete listing of the 
program: 


6 REM ALL CYAN SCREEN 
8 POKE36879,59 
19 GOSUB1200 


12 paint’ (iu AND oie 
vam (4 
Gy 6 Go 
U UU, UU UU 


7 spaces ARTWORK”:GOSUB1300 

16 FORG=1TO1@@:NEXT 

17 REM SELECT GRAPHICS 

18 GRAPHIC2 

19 REM SELECT COLORS 

20 COLOR3,3,0,10:GOSUB1500: 
GOSUB2109 

30 REM DRAW SQUARE 

35 CHAR18,7,"SQUARE”:GOSUB 





2500 
49 DRAW2,400,458TO600,4590: 
GOSUB2000 
68 DRAW2TO609,650:GOSUB2000 
88 DRAW2TO409,658:GOSUB2000 
109 DRAW2TO408,459:GOSUB20080: 
SCNCLR:GOSUB1500 
138 REM DRAW CIRCLE 
135 CHAR18,7,""CIRCLE”:GOSUB2500 
149 CIRCLE2,512,512,70,100:GOSUB 
2100:SCNCLR:GOSUB15@0 


17@ REM DRAW TRIANGLE 

175 CHARI8,7,"TRIANGLE”: 
GOSUB2560 

188 DRAW2,558,458TO350,650: 
GOSUB2000 

208 DRAW2TO759,658:GOSUB2000 

220 DRAW2TO559,450:GOSUB2000: 
SCNCLR:GOSUB15@0 

259 REM DRAW ELLIPSE 

255 CHAR18,8,“ ELLIPSE”: GOSUB25@0 

268 CIRCLE2,512,512,200,108:GOSUB 
2100:SCNCLR:GOSUB1500 

300 REM DRAW ARC 

305 CHARI8,9,“ARC”:GOSUB2500 

319 CIRCLE2,512,512,78,100,25,75: 
GOSUB2109:SCNCLR:GOSUB1500 

358 REM PLOT POINTS 

355 CHAR18,8,’’"POINTS’’:GOSUB2500 

368 POINT2,400,450,400,650,600, 
650 ,690,450:GOSUB2100: 
SCNCLR:GOSUB150@ 

495 CHAR18,3,’PAINTED CIRCLE”: 
GOSUB2500 

580 CIRCLE2,512,512,70,108:GOSUB 
2100:REGION7 

5@5 REM PAINT SHAPES 

5198 PAINT2,512,512:GOSUB2100: 
SCNCLR:GOSUB15@0 

535 REGION@:CHAR18,3,’"PAINTED 
SQUARE”:GOSUB2590 

549 DRAW2,488,450TO600,450: 
GOSUB210@ 

558 DRAW2TO689,658:GOSUB2100 

568 DRAW2TO480,658:GOSUB2190 

578 DRAW2TO489,450:GOSUB2100 

588 REGION2:PAINT2,512,512: 
GOSUB2190:SCNCLR:GOSUB 
1500 

695 REGION@:CHAR18,3,"PAINTED 
ELLIPSE’: GOSUB2500 

619 CIRCLE2,512,512,200,100:GOSUB 
2100 

620 REGION6:PAINT2,512,512: 
GOSUB2109:SCNCLR:GOSUB 
1500 

645 REGION@:CHAR18,3,“PAINTED 
TRIANGLE”: GOSUB2500 

658 DRAW2,558,459TO359,650: 
GOSUB2100 

668 DRAW2TO759,659:GOSUB2100 


670 DRAW2TO559,459:GOSUB21 90 

688 REGIONS:PAINT2,512,512: 
GOSUB2100:REGION® 

681 REM MUSIC MAKING 

686 GRAPHIC@:GOSUB1 200 


rom Geom Gem a 
t U tu Ud 


8 spaces MUSIC”: GOSUB 139: 
GRAPHIC2:GOSUB3@00 

690 REM PLAY CHORD 

691 SOUND225,225,225,0,9:FORG=1 
TO2000:NEXT:SOUND@,0,0,0,0: 
GOSUB3000 

695 R=400 

697 REM DRAW STAFF 

700 DRAW2,1,RTO999,R:GOSUB2100 

719 R=R+100:IFR>8Q0QTHEN730 

720 GOTO7@@ 

725 REM DRAW CLEF 

730 CIRCLE2,200,900,7,14 

749 DRAW2,280,980,TO200,325 

750 CIRCLE2,200,400,52,75,75,25 

760 CIRCLE2,200,663,130,196,25,75 

77 CIRCLE2,200,700,100,147,75,25 

775 CIRCLE2,200,625,60,80,5,75 

780 CIRCLE2,250,669,7,14 

799 GOSUB2500 

795 REM DRAW NOTES 

800 R=300:R1=900:A=0 

805 REGION® 

810 CIRCLE2,R,R1,28,40 

812 DRAW2,R+28,RITOR+28,R1—200 

815 A=A+1:ONAGOSUB915,929, 
925,930,935,940,945,950 

820 R=R+99:R1=R1—50 

830 IFR>1QQ@GTHENGOSUB1000 

849 GOTO810 

855 REM PLAY NOTES 


CT 


P-] 
~ 


915 PRINT” 
V9T6S202C": RETURN. 


920 PRINT” (mei 
V9T&S202D "RETURN. 








925 PRINT” 
V9T6S202E” :RETURN 


and 


CTRL 





930 PRINT” and 
V9T6S202F”:RETURN 


no0000 


935 PRINT” and 


V9T6S202G":RETU RN 


940 PRINT” | crm | and 


V9T6S202A”: RETURN 


945 PRINT” and & 


V9T6S202B":RETURN 


950 PRINT’ an 


V9T6S203T7C":RETURN 
1900 FORG=1TO5@0:NEXT 
1002 REM DISPLAY NOTES 
1005 AA$="V9T4S202” 
1006 REGIONG 
1007 CHAR4,6,”C"":PRINTAAS”CR”; 
1010 CHAR4,7,“D”:PRINT”DR”; 
1015 CHAR4,8,”E”:PRINT“ER”; 
1820 CHAR4,9,"F”:PRINT”FR”; 
1025 CHAR4,10,”G":PRINT’GR”; 
1830 CHAR4,11,”A”:PRINT“AR”: 
1035 CHAR4,12,”B”:PRINT’BR”; 
1040 CHAR4,13,"C”:PRINT’T8O3C” 
1850 FORG=1TO2000:NEXT:SCNCLR 
1067 GRAPHICG:END 


1195 REM REMOVE SCREEN 

12008 POKE36865,159:RETURN 

1295 REM SCROLL SCREEN 

1300 X1 =36865:FORJ=158TO35STEP—1: 
POKEX]1 ,J:FORG=1TO1@:NEXTG, 
J:RETURN 

1508 CHAR2,6,“ARTWORK’’:GOSUB 
2500:RETURN 


rm 
2000 PRINT’ and 


V9T2S303C":FORS= 1TO5S80: 
NEXT:RETURN 
2108 FORQQ=1TO509:NEXT:RETURN 
2500 FORW=1TO 1000:NEXT:RETURN 
3000 CHAR2,7,"“MUSIC”:RETURN 
30010 REM SUPER 
30015 REM EXPANDER 
30920 REM DEMO 


NOTES 


Adding carriage returns 

Alto voice 

Arc, drawing an 

Auxiliary color 

Axis, x and y 

BASIC, compatability with VIC 

Bass voice 

Border color 

Carriage returns, adding 

Cartridge, loading the SUPER 
EXPANDER 


Changing function key assignment 


Character color 
Character color, changing the 
Character set, musical 
Chord, playing a musical 
CIRCLE 
Circle, drawing a 
Clearing a graphics screen 
COLOR 
Color, changing the character 
Color registers 
Color values 
COLOR 
Commands, entering SUPER 
EXPANDER 
Commands, list of 
Conventions, format 
Coordinates, screen 
Debugging 
Direct mode 
Displaying music characters 
DRAW 
Drawing an arc 
a circle 
an ellipse 
a line 
Ellipse 
Entering single-note music mode 
Errors, indication of 
Expansion, memory 
Flat, playing a music note 
Function keys: 
adding carriage returns to the 
changing the values of the 
preassigned values of the 
Gradian 
GRAPHIC 
Graphics mode, high-resolution 
mixed 
multi-color 


INDEX 


11,13 
2 
2,6 


6 
1,3 
11,13 


19 
2,7,8,15 
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6,7,8,9,15 
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Grid 6 
High-resolution graphics mode 7,8,9 
Indirect mode 2 
Joystick, values returned by the 1,16,17 
KEY 2,4 
Key, RESTORE 3,12 
Keys, function 1,2 
Light Pen, values returned bythe 1 


Lines, drawing 
Loading the SUPER 

EXPANDER cartridge ] 
Matrix screen 6,7 
Memory Expansion board, VIC1010 1 
Memory, extra RAM 1, 
Mode, entering music 12 


high-resolution graphics 78,9 
multi-color graphics 6,7,8,9 
Multi-color graphics mode 6,7,8,9 


Music character display, initializing 12 
terminating 12 


Music character set 12 
Music mode, entering 12 
Octave selection 13 


Origin, screen 


Paddles, values returned by the 1,16 
PAINT 2,7,9 
Painting graphics shapes 19 
Plotting graphics 1,6 
POINT 2,8 
PRINT 11,12,15 
Printing music 11,12 
Programs, running SUPER 
EXPANDER 
Programs, terminating SUPER 
EXPANDER 
RAM, extra memory 1,2 
Range of screen coordinates 6 
RCOLR 15 
Read functions 21017 
Rectangles, drawing 
RDOT 2,16 
REGION 27,\9 
Registers, color 6,7,8,9,15 
sound 11,15 
RESTORE key 3,12 
[RETURN] 2 
RGR 215 
RJOY 16,17 
RPEN 2,16,17 
RPOT 2,16,17 
RSND 2,17 
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Screen, clearing a graphics 
border 
color 
coordinates 
matrix 
origin 
SCNCLR 


Sharp, playing a music note 
UND 


Sound registers 

Tempo, setting music 

Termination of SUPER 
EXPANDER programs 

Termination of music character 
display 

Text display 

Treble voice 

Triangles 

VIC 1010 Memory Expansion 
Board 

Voice 

Volume, setting multi-note 

setting single-note 
White noise, creating 
Zero point of screen coordinates 
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SUMMARY 


(continued from back cover) 


The parameters in the command formats are 
listed below: 


n an integer number 

“entry” a user-defined command 

SC screen background color 

bo screen border color 

ch character color 

au auxiliary color 

cr color register 

X,Y coordinates of a point on the screen 
c color 

rx half the width of a circular shape 

ry half the height of a circular shape 
as starting point of an arc in gradians 
af finishing point of an arc in gradians 
“text” character string 


sl-s4. sound voices 

so volume level 

p a single music note in the range C to B 
Z any number between @ and 255 

w a number in the range @ to 3 

U a number in the range 1 to 5 

K either 0 or 1 


The commands that are assigned to the 
function keys when the SUPER EXPANDER 
cartridge is initialized are listed below: 


KEY 1, “GRAPHIC” 


KEY 2, “COLOR” 
KEY 3, “DRAW” 
KEY 4, “SOUND” 
KEY 5, “CIRCLE” 
KEY 6, “POINT” 
KEY 7, “PAINT” 


KEY 8, “LIST” + CHR$(13) 


The colors and their associated values are listed 
below: 


@ Black 

] White 

2 Red 

3 Cyan 

4 Purple 

5 Green 

6 Blue 

7 Yellow 

8 Orange 

9 Light Orange 
10 Pink 
11 Light Cyan 
12 Light Purple 
13 Light Green 
14 Light Blue 
15 Light Yellow 


SUMMARY OF 


SUPER EXPANDER 


Ab Pur i, p 
Operation V 
Change function key assignments 


Select graphics set 
Choose colors 
Plot point(s) 


Change character color 
Draw line(s) 


Draw circular shape 

Draw arc 

Paint enclosed area 

Display text on a graphics screen 
Clear a graphics screen 

Play a chord 

Enter single note music mode 
Display music characters 

Turn off music character display 
Set volume 

Select voice 

Choose octave 

Define duration of note(s) 

Play rest(s) 

Play note(s) 


Play note following sharp 

Play note following flat 

Read graphic mode 

Read value in a color register 
Read color of a point on the screen 
Read value of a sound register 


Read value indicated by a games paddle 


Read value indicated by a light pen 


Read value indicated by the joystick 
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COMMANDS 


? ss ? 
f 1 2e,& 


Cyt 2.” foammils's & 
ver gy KREAJPMUC C 
Syntax Page 
KEY 
Oriel % GUNY <xvesurssisenonts20espanekssewens 4 
APR 2x ss dnnneniieackaeectdceadedes peneuat 7 
COUR SG QO CNG csi ccceauwecetaseunarnicdaces 7 
POINT cr,x,y 
CFP CE FY ). oct oeeeesercstaeeonts¥useneré 8 
REGGIO So ip cdawwewy su nemhoannenneepes's sumemwrs 8 
DRAW cr,x,y TO xl1,y] 
or DRAW cr,x,y TO xl,yl TO 
OP RAW GP IGF sci ccce ewe vdannakeadwewwsens 7 
foes CEAUIEAY ony cceeadnniaheungknstsaueneess 9 
CIRCLE CRAM IMT GRE oon sce stvwwwenarsvewewunas 9 
Fe Coe saneureecananens sss cuanenrs voles ees ? 
CHAR row,column,"text” 2.0... ccc ccc cece eee eee 10 
DCU \4Jdranhaees pen @hbaees eur eaesuemen ete 10 
BUM 61 S255 G4. GF ccacnws ctv wawnnnesswannny awe it 
CIRMenHerney? acs is caneeancrsisenebsrcseewenes xt 12 
DF Acie ee alee teas eRe aed Lcaeee ots ehebaaee ta: 12 
DP aia cae eanaREdiaweceus eMeTEneeedsticnke bere 12 
Mh vsonecunrusutenceueeuasatedimbeastonaeRnotean 13 
il £at0-bsuweneacesceeaneatsecaearts2anun eases ce 13 
DA. “us cimaw andes sheneadicee on deus sexecahrevaas 13 
TAY «hi cenenmaeseds seeunsieserountsesacieuese ties 13 
ES. sth eed bares Lak we eee Ie OREO Lee ce deaee ot ven 14 
OFA OG 2. nuns aigeeeeseineeueerreieeusners sas 14 
icxpiasobuces4 > checbersidwetas) 40koorasesawes 14 

pe GOA ew le anaes hee padres daueree tue 14 
Pat (Al aduaneics nowsentiecauenad1s. eoaeeKnas cess 15 
MOC SLE TO) wowriwestagreyesd bangers xeedonnt seuwas 15 
LL Oe cater edhokalivodadddsadienanyorrete da 16 
OMe Ul) a oacucsvahedsGkaiuhadeny serge keenx takes 16 
Per UE y.chcerocnwarencamaumwevaniaen dtdlet ake 16 
PP Wl anaes kanasniieneebedeccedactadtecounte 16 
PCIE He). wdvrcacemmedhrrgdukuahed asad nes baeamn 17 


The command KEY can only be entered in direct mode. The commands REGION and DRAW are 
only available in indirect mode. All other commands are available in both direct and indirect modes. 
Commands used to create graphics and the SOUND command are executed in direct mode by 
pressing the RETURN key. The remaining music commands are executed as the key associated with 
the command is pressed, after entering single note music mode. The read values must be preceded by 
the BASIC command PRINT in direct mode. In indirect (program) mode, single note music must be 


PRINTed. 
Additional summary information on reverse of this page. 
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